home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / COMM / ACSPG20.ARJ / ACSPAGE.DOC next >
Text File  |  1992-07-27  |  12KB  |  288 lines
  1.                                     ACS Page
  2.                        Shareware version 2.0 - 27 Jul 92
  3.                   Copyright 1991 Affordable Computer Services
  4.                               All Rights Reserved
  5.                           Written by George Steinmetz
  6.  
  7. DECRIPTION
  8.  
  9. ACS Page emulates a Motorola AlphaMate (Motorola and AlphaMate are trademarks
  10. of Motorola, Inc.), which is used to send text messages to alpha pagers by
  11. connecting to the alpha pager's company's computer with a 300 baud (or faster)
  12. modem.  ACS Page was compiled with Microsoft BASIC Professional Development
  13. System version 7.0.  A database of users and their pager info is required prior
  14. to operation (see Installation).  The database is made with any text editor.
  15. The database can have a maximum of 100 pagers.
  16.  
  17.  
  18. INSTALLATION
  19.  
  20. Create a text file named ACSPAGE.DAT using any text editor.  Line 1 is the
  21. modem port to use (enter as COM1 or COM2).  The next lines are for optional
  22. commands.  To send a custom modem command, enter /AT followed by the modem
  23. command.  (Example: 9600 bps and higher speed modems should enter /ATN to
  24. disable attempting to connect at a high baud rate.)
  25.  
  26. The default screen color is white text on a black background.  There are two
  27. ways to change these colors.  The first method is to add SET FCOLOR=n and SET
  28. BCOLOR=n to your AUTOEXEC.BAT file.  (Replace n with a color code in the color
  29. chart below.)  These environment variables will be used in all future
  30. Affordable Computer Services programs.  The second method is to add /FC:n and
  31. /BC:n in ACSPAGE.DAT.
  32.  
  33. FCOLOR and /FC set the foreground color; BCOLOR and /BC set the background
  34. color.
  35.  
  36. Color chart (n = 0 - 15 for foreground, 0 - 7 for background)
  37.  
  38.  0 Black             4 Red               8 Gray             12 Light red
  39.  1 Blue              5 Magenta           9 Light blue       13 Light magenta
  40.  2 Green             6 Brown            10 Light green      14 Yellow
  41.  3 Cyan              7 White            11 Light cyan       15 Bright white
  42.  
  43. The next 3 lines in ACSPAGE.DAT is a person's name (7 characters maximum, the
  44. first character must be a letter of the alphabet), their pager ID, and the
  45. pager's computer's phone number.  Repeat these 3 lines for up to 100 users.
  46. Note:  Do not enter any blank lines.
  47.  
  48. (ACSPAGE.DAT's file structure can also be listed by entering ACSPAGE /?  at the
  49. DOS prompt.  This help screen will also appear if ACSPAGE.DAT is not found.)
  50.  
  51. ACSPAGE.DAT does not need to be in the current directory, nor the directory
  52. ACSPAGE.EXE is in.  If ACSPAGE.DAT is not in the current directory, enter
  53. ACSPAGE {directory}, i.e. ACSPAGE \COMM\ACSPAGE.
  54.  
  55.  
  56. NOTES
  57.  
  58. This program is for alpha pagers, not digital or tone only pagers.
  59.  
  60. The phone number required is NOT the number you call to get the paging
  61. company's operator, nor is it the pager's digital number.  It is a number
  62. connected to a 300 baud modem.  The easiest way to see if you have the right
  63. number is to call it.  If you don't hear a modem, you don't have the right
  64. number.  To get the right number, call your pager company, tell them you have a
  65. Motorola AlphaMate and you need the number the AlphaMate should be programmed
  66. to call.  (Don't bother telling them it's really a computer program that works
  67. like an AlphaMate, it will just confuse them.)
  68.  
  69. To dial rotary (pulse) instead of DTMF (Touch-Tone), enter a P before the phone
  70. number.  If a number is required to access an outside line, enter that before
  71. the phone number.
  72.  
  73.  
  74. OPERATION
  75.  
  76. When prompted with "Enter Pager Name or #", enter a user's name or a pager ID.
  77. If an ID is entered, you will also be prompted for a phone number.  You may
  78. also press ENTER or ESC to exit to DOS.  Enter a message (up to 80 characters)
  79. at the "Message" prompt.  At the "Send, Review, Next or Quit" prompt, enter S
  80. to send the page, R to review the page, N to enter another page (can be to the
  81. same or different pager IDs and phone numbers) or Q to quit.
  82.  
  83. Four dial attempts will be made to make contact with the paging computer.  To
  84. abort before all four attempts, enter Esc (similar to AlphaMate's Quit key).
  85.  
  86. When all pages are sent, the "Enter Pager Name or #" prompt will reappear.
  87. Enter more pages, ore press Esc to quit the program.  (To quit automatically
  88. after pages are sent, add the /Q command line option.  Example:  If you
  89. normally enter ACSPAGE \COMM\ACSPAGE to run ACS Page, enter ACSPAGE
  90. \COMM\ACSPAGE/Q to quit after all pages are sent.)
  91.  
  92.  
  93. COMMAND LINE OPTIONS
  94.  
  95. ACS Page's data can be entered from the DOS command line.  This is useful when
  96. running ACS Page from another program.  To page from the command line, ACS Page
  97. needs the message and the name as defined in ACSPAGE.DAT.  Alternatively, a
  98. pager ID and phone number can be entered instead of a name.
  99.  
  100. ACS Page's command line options are:
  101.  
  102. /N - user's name as defined in ACSPAGE.DAT
  103. /I - pager's ID
  104. /P - pager company's phone number
  105. /M - message to be sent to pager (enclose message in quotes)
  106. /G - group page (transmit message to all users in ACSPAGE.DAT)
  107. /F - path\file to be sent to pager
  108. /Q - quit after paging
  109. /NOVIDEO - disable video output
  110. /DEBUG - displays serial input/output
  111.  
  112. These parameters can be entered in any order.  /G can not be combined with /F,
  113. and /NOVIDEO can not be combined with /DEBUG.
  114.  
  115. Two examples of auto paging (paging without asking for any user input) are:
  116.  
  117. ACSPAGE /N:GEORGE /M:"THIS IS A TEST"
  118. ACSPAGE /I:5551212 /P:18005551212 /M:"THIS IS A TEST"
  119.  
  120. If the path of ACSPAGE.DAT is also entered on the command line, it must be the
  121. first item.  Example:
  122.  
  123. ACSPAGE \COMM\ACSPAGE /N:GEORGE /M:"THIS IS A TEST"
  124.  
  125. To only prompt the user for a message and to always page the same person,
  126. enter:
  127.  
  128. ACSPAGE /N:GEORGE
  129. ACSPAGE /I:5551212 /P:18005551212
  130.  
  131. To only prompt the user for a pager ID or name and phone number and to always
  132. transmit the same message, enter:
  133.  
  134. ACSPAGE /M:"THIS IS A TEST"
  135.  
  136. To group page (send the same message to all users in ACSPAGE.DAT), enter:
  137.  
  138. ACSPAGE /G /M:"THIS MESSAGE WILL BE SENT TO ALL USERS."
  139.  
  140. Entering ACSPAGE /G will prompt the user for the message, then the message will
  141. be sent to all users.
  142.  
  143. To send the contents of TEXT.TXT to a user, enter:
  144.  
  145. ACSPAGE /F:TEXT.TXT
  146.  
  147. ACSPAGE /G /M:"THIS MESSAGE WILL BE SENT TO ALL USERS."
  148.  
  149. Entering ACSPAGE /G will prompt the user for the message, then the message will
  150. be sent to all users.
  151.  
  152. The /Q option is not required when auto paging; ACS Page automatically exits to
  153. DOS after paging when in auto page, group page or file page mode.
  154.  
  155.  
  156. ERRORLEVELS
  157.  
  158. When ACS Page exits, it uses DOS's ERRORLEVEL variable.
  159.  
  160. Errorlevel Description
  161. ---------- -----------
  162.          0 Page successful
  163.          1 Page fail
  164.          2 User error or abort
  165.        255 Program error
  166.  
  167. Note that errorlevels will only be accurate when auto paging, group paging,
  168. file paging or using the /Q option, as a manual exit will result in an
  169. errorlevel 2 for user abort.
  170.  
  171.  
  172. FILE USAGE
  173.  
  174. ACS Page reads a file called ACSPAGE.DAT.  If you already have a file by this
  175. name, it's name must be changed or the ACSPAGE.DAT that ACS Page uses must be
  176. loaded in a separate subdirectory.
  177.  
  178.  
  179. NOTE TO BBS USERS AND SHAREWARE VENDORS
  180.  
  181. If you received this file from a BBS, the following message should appear when
  182. you use PKUNZIP to extract this program:
  183.  
  184. Authentic files Verified!   # VBI707   Affordable Computer Services
  185.  
  186. If this message did not display, then the .ZIP file you received is not the
  187. original.  Call The Other BBS at the number displayed below to download the
  188. original .ZIP file (you can download on your first call).
  189.  
  190.  
  191. CUSTOM PROGRAMMING
  192.  
  193. If custom programming is requested, contact Affordable Computer Services by
  194. mail at the address shown below.
  195.  
  196.  
  197. REGISTRATION
  198.  
  199. If you like this program, please mail a check or money order for $10 (New
  200. Jersey residents add state sales tax) to:
  201.  
  202.      Affordable Computer Services
  203.      PO Box 969
  204.      Belmar, NJ 07719-0969
  205.  
  206. Along with the registration fee, please also enclose the following:
  207.  
  208. o Your mailing address.
  209. o A telephone number you can be reached at in case of any registration
  210.   problems.
  211. o The name and version of the program you are registering.
  212. o Your name or company name exactly as you wish it spelled on your registered
  213.   copy (upper and lower case).
  214.  
  215. If no voice contact was made prior to mailing your registration, you will
  216. receive a postcard with your registration ID.  The postcard will also state the
  217. current version number and what BBSes the upgrade has been uploaded to.  When
  218. an upgrade is made to the program, a second postcard will be sent to you
  219. describing the upgrade and what BBSes the upgrade has been uploaded to.  To
  220. continue to receive upgrade postcards, send $1 when an upgrade postcard is
  221. received.
  222.  
  223. You may also register by using the American Express Card.  You may register
  224. with the card by one of the following methods:
  225.  
  226. o By mail at the above address.
  227. o By voice at 800-929-0110 or 908-449-3836.
  228. o By fax at 800-929-0631 or 908-449-9357.
  229. o Online (The Other BBS) at 908-775-6705.
  230.  
  231. To process your registration, you must supply the above information as well as
  232. the following information:
  233.  
  234. o Your name exactly as it appears on the card.
  235. o Your card's account number.
  236. o Your card's expiration date.
  237. o Your card's billing address.
  238.  
  239. When registering with the American Express card on The Other BBS, you will
  240. receive your registration ID in a private message within 24 hours of your
  241. registration.
  242.  
  243. Any questions about this program may be addressed to George Steinmetz on The
  244. Other BBS, 908-775-6705 (RIME Echomail ID: OTHER), or write, call or fax
  245. Affordable Computer Services at the address and phone numbers listed above.
  246.  
  247.  
  248. REVISION HISTORY
  249.  
  250. Version 2.0 - 27 Jul 92
  251. o PAGER.EXE and PAGER.DAT have been renamed to ACSPAGE.EXE and ACSPAGE.DAT.
  252. o Esc key aborts page in progress (like AlphaMate's Quit key).
  253. o Page aborts after four dial attempts.
  254. o Page aborts after three bad checksums on a page attempt.
  255. o Page aborts after 15 seconds of no transmission from paging computer.
  256. o Paging can be performed with command line options.
  257. o /G command line option added, sends message to multiple users.
  258. o /F command line option added, sends contents of a text file.
  259. o /Q command line option added, quits program after page.
  260. o /? command line option added, displays command line options.
  261. o /NOVIDEO command line option added, disable video output.
  262. o /DEBUG command line option documented, displayes serial I/O (feature exists
  263.   in earlier versions).
  264. o ERRORLEVEL is set upon exiting.
  265. o Error messages have been expanded.
  266. o /AT option added to ACSPAGE.DAT, sends custom modem command.
  267. o FCOLOR and BCOLOR environment variables added, changes default colors.
  268. o /FC and /BC options added to ACSPAGE.DAT, changes default colors.
  269. o Modem resets when program is exited.
  270. o Modem does not require carrier detect to be forced on (formerly required on
  271.   some modems).
  272. o Invalid pager ID code is now interpreted (acts like page rejected).
  273. o Review feature displays like AlphaMate does.
  274. o Beep is the same frequency as the AlphaMate.
  275. o Registration ID removes shareware notice.
  276.  
  277. Version 1.1 - 04 Feb 92
  278. o PAGER.TXT renamed to PAGER.DAT.
  279. o Documentation modified - PAGER.DAT contents now listed in correct order.
  280. o Program does not report "Error 62 in 410" if PAGER.DAT file has an incorrect
  281.   amount of lines.  Instead, the current user is discarded and the program
  282.   operates with all previous users loaded in memory.  If no users can be
  283.   successfully loaded, a help message appears.
  284. o American Express Cards can be used to register program.
  285.  
  286. Version 1.0 - 23 Nov 91
  287. o Original release.
  288.